﻿Accessible Diabetes Tracker, version 1.0

Thank you for using this program.

What it is
A Windows program for people with diabetes, built to be fully usable with a screen reader such as NVDA. It reads glucose files from your Libre sensor (downloaded from the LibreView website) or your Dexcom sensor (exported from the Dexcom Clarity website), and your own food log, and shows plain-language summaries.

Important
This program shows facts about your own readings. It does not give medical advice. Talk to your doctor or nurse about any decisions about your health.

You use this program at your own risk. The information it shows may be incomplete or wrong, for example if a file is missing readings, a reading from the sensor was off, or the program read something incorrectly. The program is provided as it is, with no promise that it is accurate or will work without problems. You are responsible for any decisions you make, and any actions you take, based on what this program shows you. Jarrod Jicha (the developer of this program) is not responsible for those decisions or actions, or for anything that happens because of them. Always check with your doctor or nurse before changing how you eat, exercise, or take your medicine.

This program was written using AI (artificial intelligence). Jarrod Jicha designed it and tested it, along with beta testers, but because it was written using AI, something could be missing or not work quite right. If you would rather not use a program written using AI, close the agreement with Close program when it is shown. Nothing will have been saved or sent.

Getting started
1. Unzip this folder somewhere you can find it, such as your Documents folder.
2. Open the folder and start "Accessible Diabetes Tracker.exe".
3. The first time, an agreement is shown. Read it, tick the box, and press Start. Then the program asks once which sensor you use (Libre or Dexcom). Your answer sets the sensor length for Sensor days left, and which website the Import window opens for your file. Escape keeps the choice already in Settings. You can change it any time in Settings, on the Readings tab, under Sensor length. People updating from an earlier version are asked this once too.
4. Press Import data (Alt+I) to bring in a glucose file from LibreView or Dexcom Clarity, or your food log. Right after the File type choices is a button that opens the website where you download your readings file, in your own web browser: "Open LibreView to get my file", or "Open Dexcom Clarity (United States) to get my file" ("outside the United States" when Glucose units in Settings is mmol/L). Which one it shows follows Sensor length in Settings. You still sign in and download the file yourself; the program can't do that for you, and it sends nothing. If you always save your downloaded file in the same folder, choose that folder in Settings, on the Readings tab, under My readings folder (Alt+M): press Pick a folder (Alt+P). Then each time the program opens, it quietly looks at the newest .csv file in that folder, going by when it was saved, not its name. If that file has readings you haven't imported yet, it says so and asks whether to import it. Yes (which Enter presses, since nothing is imported until you press Import) opens the Import window and reads the file for you, so you can check it before pressing Import. No won't ask about that download again, but it will ask when a newer one is saved. Don't look in any folder (Alt+Y) turns this off. It starts with no folder chosen. To get your newest readings, open the Libre app and check your sugar first, then download the file from LibreView right away: LibreView only gets your newest readings after you check in the app.

Windows may show a message such as "Windows protected your PC" the first time, because this test version is not signed. If you trust the person who gave it to you, choose More info, then Run anyway.

Where your information is kept
Everything stays in this folder on your computer. Apart from the program itself, README.txt and Change log.txt, it is all in the folder named data: your readings, your food log (log.txt), your settings (settings.txt), your saved food lookups, and the Backups folder. If you used a beta from before this was so, the program moves them into the data folder by itself the first time it opens, and tells you. None of it is sent anywhere. Only two things ever leave your computer. A Food lookup sends the name of the food you typed, and the email address you entered in Settings, to the Open Food Facts food database, and only after you say yes. If you chose the USDA's FoodData Central in Settings, it also sends the food name and your USDA key to the USDA. Checking for updates asks the program's website, www.jjhof.com/adt, whether a newer version is out; nothing about you or your health is sent, and it only checks when you press Check for updates, or when the program opens if you chose that. (Helpful resources, the Import window's get-my-file button and the "Get a free USDA key" button just open a web page in your own browser, like following a link; the program sends nothing.) Only one copy of the program can run on the computer at a time, even from different folders: if you start it again while it is open, it says so and takes you to the open copy. To move the program to another computer, copy the whole folder. If you use a USDA key, type it in Settings again on the new computer (see Food lookup).

Copying the folder between computers
If you copy one computer's folder over another's, Windows replaces that computer's food log and readings, and anything added there since is lost from them. To protect against this, the program keeps a safety copy of your food log and readings in the data\Backups\Safety copies folder, named after the computer. When the program opens, if food log entries or readings that were there the last time you used it on this computer are missing, it says how many and asks whether to put them back. Yes (which Enter presses here, because putting back only adds) adds them back without removing or changing anything; missing food log entries go at the end of your food log. Choose No if you removed or changed them yourself on purpose. Then nothing is changed, and that safety copy is kept in the same folder, in files whose names start with "Not put back". Only the last 5 of these are kept. Safety copies are made even when backups are turned off in Settings, but only the newest one for each computer is kept, so they don't pile up.

To bring in what another computer's copy added, without copying its folder over this one, use Import data (Alt+I): under File type choose "Another copy of this program", then press Browse and choose the other copy's folder (for example, on a USB stick or in Dropbox). Read file says how many new food log entries, readings and saved food lookups it has. Import makes backups first (if backups are on), then adds only what is new. Nothing already here is removed or changed, and the other copy is not changed. If both copies saved a food lookup for the same food, the newer one is kept. Settings are not brought in, since each computer keeps its own.

Dexcom: if you use a Dexcom sensor, sign in to the Dexcom Clarity website on a computer, open a report, and use its Export button to download a file ending in .csv. Then in Import data, under File type choose "Dexcom Clarity file", press Browse, choose the file, and press Read file. Files in mg/dL and mmol/L both work. The person's name, date of birth, device details and alert settings at the top of the file are skipped and never kept. When your sugar was above what the sensor can measure, the file says "High" instead of a number: the program keeps it as 400 mg/dL (22.2 mmol/L) and shows it as "High (above 400)" everywhere, so highs are never lost. "Low" is kept as 40 mg/dL (2.2 mmol/L) and shown as "Low (below 40)", and counts as a low. Readings from a blood sugar meter in the file (entered in the Dexcom app or used to calibrate the sensor) are kept as finger-stick readings. Insulin doses you logged in the Dexcom app are added to your food log, each with its own date and time, such as "Fast-acting insulin: 3.5 units (from Dexcom)", so they show in Meals and responses and the doctor report. Importing the same file again never adds a reading or a dose twice.

A file the program can't read yet: if Read file can't read a readings file at all (for example a LibreView file in mmol/L, from outside the United States), it offers to save a layout report. Choose Yes, and the program saves "layout report.txt" in the data folder, says exactly where that is on your computer, and opens it in Notepad. The report shows only how the file is laid out: every number is changed to 9, and words that appear only a few times, such as your name, are changed to x's, so your readings are not in it. Read it first, remove anything you would rather not send, then email it as an attachment to the address in About. That lets support for that kind of file be added without you sending your real file. The program never sends the report itself.

Keys
Tab and Shift+Tab move between controls. Enter or Space presses a button. In Food lookup, Enter in the box searches, and Enter on a match gets more details for it. In Meals and responses, Enter in the words box presses Show. In Week highs and lows, Enter in the Number box presses Find. In other boxes and lists, Enter does nothing. Space ticks or unticks a checkbox. The arrow keys move between the choices in a group of radio buttons. Escape closes a window without changing anything.

Every button and box also has an Alt shortcut, listed below window by window, and the main window has menus and Ctrl quick keys. Some screen readers, such as NVDA, say the shortcut when you reach the control; others, such as JAWS on some computers, do not, so the full list is here.

Main window
The main window has a few everyday buttons, the Results box, and a menu bar with everything else. Each menu opens with Alt and its letter, such as Alt+R for Readings, or press Alt alone and use the arrow keys, as in other programs. In an open menu, press an item's letter, or move to it with the arrow keys and press Enter. Escape closes a menu.

Buttons in the main window
Alt+L  Latest reading
Alt+Y  Today's readings
Alt+I  Import data
Alt+E  Add log entry
Alt+G  Add finger-stick reading
Alt+S  Results

File menu (Alt+F)
I  Import data
D  Doctor report
L  Open my log in Notepad
C  Close the program

Readings menu (Alt+R)
L  Latest reading
T  Today's readings
W  Week highs and lows
M  Meals and responses
C  Compare
P  Patterns by time of day
A  Estimated A1C

Add menu (Alt+A)
E  Add log entry
F  Add finger-stick reading
R  Finger-stick readings (to edit or remove them)

Tools menu (Alt+T)
F  Food lookup
S  Sensor days left
T  Settings (also Ctrl+Comma)

Help menu (Alt+H)
H  Helpful resources (opens trusted links about diabetes on the program's website)
U  Check for updates
A  About (which version you have, and how to get in touch)

Quick keys, which work anywhere in the main window without opening a menu (each menu also shows its item's quick key):
Ctrl+L  Latest reading
Ctrl+T  Today's readings
Ctrl+W  Week highs and lows
Ctrl+M  Meals and responses
Ctrl+D  Doctor report
Ctrl+I  Import data
Ctrl+E  Add log entry
Ctrl+G  Add finger-stick reading
Ctrl+F  Food lookup
Ctrl+Comma  Settings

Meals and responses window
Alt+R  Date range
Alt+F  From month (Tab goes on to From day and From year)
Alt+O  To month (Tab goes on to To day and To year)
Alt+W  Words to look for
Alt+S  Show
Alt+U  Results
Alt+C  Close

Update window (when a newer version is found)
Alt+W  What's new
Alt+Y  Yes, update now (the program restarts)
Alt+N  No, not now
Alt+S  Skip this version (only when the program opens and you chose Ask me first)

After an update (the first time you open the new version)
Alt+W  What's new
Alt+O  OK

Updates question (asked once)
Alt+N  New: updates for Accessible Diabetes Tracker
Alt+A  Update automatically
Alt+F  Ask me first
Alt+D  Don't check when the program opens

Sensor question (asked once)
Alt+A  About this question
Alt+S  Which sensor do you use?
Alt+O  OK

Import window (it opens on File type; Tab then goes to the get-my-file button, the file box and Browse)
Alt+T  File type
Alt+G  Open LibreView or Dexcom Clarity to get my file
Alt+F  File or folder to import
Alt+B  Browse
Alt+R  Read file
Alt+I  Import
Alt+C  Close
Alt+S  Results

Doctor report window
Alt+R  Date range
Alt+F  From month (Tab goes on to From day and From year)
Alt+O  To month (Tab goes on to To day and To year)
Alt+I  Include in the report
Alt+W  Word to look for
Alt+Y  Your name
Alt+B  Date of birth
Alt+M  Remember my name and date of birth on this computer
Alt+N  Note for your doctor
Alt+S  Read report summary
Alt+V  Save report
Alt+C  Close
Alt+U  Results

Add log entry window
Alt+D  Date month (Tab goes on to Date day and Date year)
Alt+T  Time
Alt+E  Entry
Alt+S  Save
Alt+C  Cancel

Add finger-stick reading window (and the window for editing one)
Alt+D  Date month (Tab goes on to Date day and Date year)
Alt+T  Time
Alt+R  Reading
Alt+U  Unit (mg/dL or mmol/L)
Alt+S  Save
Alt+C  Cancel

Finger-stick readings window
Alt+R  Readings, newest first
Alt+E  Edit
Alt+M  Remove
Alt+C  Close

Food lookup window
Alt+F  Food to look up
Alt+S  Search
Alt+T  Matches
Alt+D  Details
Alt+M  More details
Alt+C  Close

Settings window (Ctrl+Comma from the main window)
Settings has five tabs. It opens on the General tab, on the tab names: Tab goes into the choices on that tab, the arrow keys on the tab names change tabs, and Ctrl+Tab and Ctrl+Shift+Tab change tabs from anywhere in Settings. Every Alt shortcut works from any tab, and takes you to the tab its choice is on. Save and Cancel are below the tabs, and Save saves the choices on every tab at once.

General tab
Alt+T  Time format
Alt+G  Glucose units (mg/dL or mmol/L)
Alt+O  When the program opens

Readings tab
Alt+N  Sensor length (Libre or Dexcom)
Alt+W  Target range low number
Alt+H  Target range high number
Alt+M  My readings folder
Alt+P  Pick a folder
Alt+Y  Don't look in any folder

Food lookup tab
Alt+E  Email address for food lookup
Alt+D  Also look up foods in the USDA's FoodData Central
Alt+F  Get a free USDA key (only there when the USDA box is ticked)
Alt+K  USDA key (only there when the USDA box is ticked)

Updates tab
Alt+U  Updates when the program opens
Alt+I  Which updates (stable releases only, or betas too)

Backups and help tab
Alt+B  Make a backup before each import
Alt+R  Restore from a backup
Alt+L  Problem log
Alt+V  View the problem log in Notepad
Alt+A  Read the agreement

Below the tabs
Alt+S  Save
Alt+C  Cancel

Restore from a backup window (from Settings)
Alt+B  Backups, newest first
Alt+R  Restore
Alt+C  Close

Sensor days left window
Alt+D  Days left
Alt+P  Date put on month (Tab goes on to the day and year)
Alt+T  Time put on
Alt+S  Save
Alt+C  Close

Compare window
Alt+W  What to compare
Alt+F  From month (Tab goes on to From day and From year)
Alt+O  To month
Alt+R  Earlier from month
Alt+T  Earlier to month
Alt+S  Show
Alt+U  Results
Alt+C  Close

Week highs and lows window
Alt+W  Week highs and lows
Alt+H  Or higher
Alt+L  Or lower
Alt+N  Number
Alt+F  Find
Alt+R  Find results
Alt+C  Close

Patterns by time of day window
Alt+D  Days to look at
Alt+S  Show
Alt+U  Results
Alt+C  Close

Estimated A1C warning (shown each time you press Estimated A1C)
Alt+P  Please read
Alt+U  I understand and agree
Alt+C  Cancel

Agreement window (shown the first time the program opens)
Alt+G  Agreement
Alt+I  I have read this and understand it
Alt+S  Start
Alt+C  Close program

Your food log
Your food log is a plain text file, log.txt, in the data folder, where you write down what you ate, medicine you took, sensor changes, or anything else, each with its date and time. The first time you start the program, it offers to create one for you. Press Add log entry (Alt+E) to write an entry without Notepad: the date and time are filled in with now, and you can change them (the date is picked from month, day and year boxes; see "Picking a date"). Type the entry, then press Tab to reach Save and press it. The entry box can hold several lines: Enter starts a new line, so one entry can say, for example, that you changed your sensor and what you ate. Enter only saves when you are on the Save button. After saving, you can add another entry or close the window. A backup of your food log is made before each entry, if backups are on in Settings. You can still write in log.txt with Notepad if you like; the program reads both the same way. Open my log in Notepad, in the File menu, opens it for you. The next time you start the program, it tells you about any new entries you wrote in Notepad, and offers to show them with your sugar around each one. In Notepad, put each entry's time and date on its own line (F5 writes them for you), then your words, then a blank line, and save when you are done.

Finger-stick readings
If your sensor breaks or falls off, or only shows "HI" or "LO", and you check your sugar with a finger stick on a blood sugar meter (or someone else does, such as your doctor or nurse at their office, or an ambulance crew), you can add that reading to the program. Press Add finger-stick reading (Alt+G). The date and time are filled in with now; change them if the reading was earlier. Type the number the meter showed in Reading, then press Save. Unit starts on the glucose units chosen in Settings (see "Glucose units" below). If the meter shows the other unit, such as a meter from another country, choose it under Unit for that reading; the message after Save then gives both numbers. There are no limits, because meters can read very high or very low: anything over 0 can be saved. Only if a reading is over 750 or under 20 mg/dL (over 41.7 or under 1.1 mmol/L) does it ask whether you typed it correctly and want to save it anyway; No, the button Enter presses, takes you back to fix it. A backup of your readings is made before each one is saved, if backups are on in Settings. After saving, you can add another reading or close the window.
Finger sticks count like the sensor's readings in Latest reading, Today's readings, Week highs and lows, Meals and responses, Estimated A1C, and the doctor report's average and highest and lowest, and they are marked "(finger stick)" wherever a reading is shown. They are not counted in time in range, glucose variability, lows, or gaps, because those are worked out from the sensor's steady readings every few minutes.
To fix a mistake, choose Finger-stick readings in the Add menu. It lists your finger-stick readings, newest first. Choose one with the arrow keys, then press Edit to change its date, time or number, or Remove to delete it; Remove asks first, with No as the button Enter presses. Enter on the list itself does nothing, so nothing is changed by accident. Only finger-stick readings are listed, so the sensor's readings can never be changed or removed here. A backup is made first, if backups are on.

Glucose units
In the United States, glucose is measured in mg/dL, such as 130. Many other countries use mmol/L, such as 7.2. In Settings, under "Glucose units" (Alt+G), choose "mg/dL (used in the United States)" or "mmol/L (used in many other countries)". It starts on mg/dL. With mmol/L, every number the program shows is in mmol/L with one decimal place: the summaries, Meals and responses, finger-stick readings, your target range and the doctor report, whose standard ranges are then written as under 3.0, 3.0 to 3.8, 3.9 to 10.0, 10.1 to 13.9 and over 13.9, with lows under 3.9. Estimated A1C and GMI also give the A1C in mmol/mol, which many countries use, such as "6.0% (42 mmol/mol)". The program keeps every reading in mg/dL, so changing this setting never changes your data, and you can switch back and forth. Import data reads LibreView files in mg/dL, the kind LibreView gives in the United States, and Dexcom Clarity files in mg/dL or mmol/L. LibreView files in mmol/L, from outside the United States, are coming in a later release.

Your target range
Today's readings and Week highs and lows say how much of the time your sugar was below, within and above your target range. It starts as 70 to 180 (3.9 to 10.0 in mmol/L). If your doctor or nurse gave you a different range, change it in Settings: type the numbers in "Target range low number" (Alt+L) and "Target range high number" (Alt+H), from 40 to 400 as whole numbers, or 2.2 to 22.2 with up to one decimal place if you chose mmol/L, with the low number smaller than the high one, then press Save. If you change Glucose units, the numbers in these boxes change to the new unit straight away. The doctor report always uses the standard ranges that doctors expect, whatever your target range is.

Meals and responses
Meals and responses (in the Readings menu, or Ctrl+M) shows your food log entries with your sugar before and after each one. A window opens where you choose which entries to see. Under Date range, choose Today (from midnight until now), Last 24 hours (from this time yesterday until now), Last 7 days, Last 14 days, Last 30 days, All entries, or My own dates. It always starts on Last 7 days. With My own dates, pick the first and last day in the From and To boxes (see "Picking a date" below); they start on 7 days ago and today. To see only certain foods, type them in "Words to look for", such as chocolate cake; leave it empty to see every entry in those dates. Words are matched as whole words, and capital letters don't matter, so "cake" finds "Chocolate Cake" but not "cupcake". Press Show, or Enter in the words box, and the entries appear in Results. You can change the dates or words and press Show again as often as you like. Close or Escape goes back to the main window.

Picking a date
Dates are never typed. In Meals and responses, the Doctor report, Add log entry and Add finger-stick reading, each date is three combo boxes, one after the other: month, day and year, such as "From month", "From day" and "From year". Your screen reader may say "collapsed"; that is normal. You don't need to open the list: Up and Down arrow move through the choices, Home and End go to the first and last, and Page Up and Page Down move several at a time. In the month box, typing a letter jumps to a month starting with it, such as F for February. Tab goes to the next box. Months are listed by name, and the day box lists only the days that month has, so a date that doesn't exist, such as February 30th, can't be picked; if you change the month and the day is too big for it, the day becomes the month's last day. Years go from 2010 to 2100, and each year box starts on the date already there, so you usually only need to change one or two boxes. If the From date is after the To date, you will be told, and nothing is shown.

Food lookup
Type a food in "Food to look up" and press Enter, or press Search. Food lookup finds foods in Open Food Facts, a free food database filled in by volunteers, and tells you what it says about them: carbohydrate, sugars, fiber and calories per 100 grams. It needs your email address in Settings, because Open Food Facts asks every program to send one with each search. Before the first search each time you open the window, it asks whether to send the food name and your email; No is the safe choice. Searches are limited to 10 a minute, as Open Food Facts asks.
Matches are often messy: the same food may be listed more than once with different amounts, and a search for "hot dog" may find hot dog buns first. Serving sizes and ingredients aren't part of the search. Press Enter on the match you are on, or press More details, to try to get them. Sometimes Open Food Facts is too busy to send them, or doesn't have them; if so, you will be told, and you can try again later or check the package. Food lookup shows what Open Food Facts says; it does not tell you what or how much to eat.
Each search, and each More details, is saved in the data folder in "food lookups.json", so foods you have looked up before still work without internet. Food lookup always tries Open Food Facts first, so you get the newest information when you can. Only if it can't be reached, or is busy, does it use the saved matches for the same words (capital letters and spacing don't matter), and it tells you when they were saved.
Every match ends with where it came from, such as "(Open Food Facts)" or "(USDA)".

The USDA's FoodData Central
You can also have Food lookup search the USDA's FoodData Central, the U.S. government's food database. It is good at plain foods, such as an apple, white rice or a hot dog, and has many brand names too. It needs a key: a code that is free, and that the USDA gives to each person. In Settings, tick "Also look up foods in the USDA's FoodData Central" (Alt+D). Two things then appear right after it. Press "Get a free USDA key" (Alt+F) to open the USDA's sign-up page in your web browser; fill it in, and the USDA emails you your key. Copy the key from the email, paste it in the "USDA key" box (Alt+K), and press Save. Settings won't save with the box ticked and the key box empty. If you untick the box later, the key is kept, so ticking it again doesn't need a new one. Your key allows 1,000 searches an hour. Please keep it to yourself: the USDA turns off any key it finds shared in public. To keep it safe, the program never writes your key in its own files. Windows keeps it, in Credential Manager, the same place other programs keep saved passwords, for your Windows account on this computer only. So if you copy the program's folder to another computer, the key doesn't go with it: type it in Settings again there. If you used a USDA key in an earlier beta, the program moves it out of settings.txt and into Credential Manager by itself. You can see it in Credential Manager, under Windows Credentials, as "Accessible Diabetes Tracker USDA key". To remove it, tick the USDA box, empty the USDA key box, untick the USDA box again, and press Save; or remove it in Credential Manager.
With the USDA chosen, each search sends the food name and your key to the USDA, and the USDA's matches are listed first, then Open Food Facts'. For a USDA match, More details gives the serving size, the ingredients, and amounts the USDA lists, such as "1 medium, 200 grams: carbohydrate 29.6 grams", when it has them; these come with the search, so they work without internet too. If one of the two can't be reached, you are told, and the other's matches are listed. If the USDA doesn't accept your key, you are told, so you can check it in Settings. With no email address in Settings, only the USDA is searched.

Reminder to import
When the program opens, if your newest reading is 3 days old or more, a message says so, and reminds you to download a new file from LibreView and press Import data. It comes at most once a day. It also gives the tip to check your sugar in the Libre app first, so the file has your newest readings.

After an import
When an import adds readings, the import results end with a short summary of just the new ones: the dates they cover, the average, time in your target range, lows (under 70 for at least 15 minutes) with the longest and the lowest, and the highest reading.

Sensor days left
The Libre app is the main place to check how long your sensor has left. Sensor days left (in the Tools menu) is only another way to see it, and it is only right if you enter each new sensor there. The LibreView file can't show when you change sensors, so the program needs you to tell it. In the window, the Days left box says when your sensor ends and how long is left. To enter a new sensor, pick the date you put it on from the month, day and year boxes, type the time in "Time put on" (they start on now), and press Save. Enter the time you put the sensor on and started it in the Libre app, not when its one-hour warm-up ended. A sensor's days count from when its warm-up ends, so the program adds the hour itself. After your next import, it finds the new sensor's first reading, which is when the warm-up really ended. If that comes within 5 minutes of the hour, it keeps the hour, since LibreView saves a reading only every 5 minutes; otherwise it counts from the first reading; if that moves the end by more than a few minutes, the import results say so. The time you entered is never changed. In Settings, choose the Sensor length (Alt+N): "15 days (FreeStyle Libre 2 Plus or 3 Plus)", which it starts on, "14 days (FreeStyle Libre 2 or 3)", "15 days (Dexcom G7 15 Day)" or "10 days (Dexcom G7)". Each has its own warm-up: an hour for the Libres and the Dexcom G7 15 Day, and 30 minutes for the Dexcom G7. A Dexcom sensor also has a 12-hour grace period after its end, to give you time to change it: Sensor days left gives the official end and says when the grace period ends, the 3, 2 and 1 day warnings count to the official end, and the program only asks whether you put on a new sensor once the grace period is over.
When the program opens and your sensor has 3 days or less left, a message tells you when it ends. This comes once at 3 days left, once at 2 and once at 1.
The program never assumes you changed your sensor; it asks. If your sensor's time is up and you haven't entered a new one, it asks once whether you put on a new one. Yes opens Sensor days left to enter when; No means you aren't asked again about that sensor, in case you have run out of sensors or couldn't change it yet. If readings later come in from after your old sensor ended, after a gap, that is a sign of a new sensor, so it asks once more, and suggests a time about an hour before those readings (a new sensor warms up for about an hour), which you can change. It also asks once about a gap in your readings that could be a sensor change, such as one near a food log entry that mentions a sensor.

Compare
Compare (in the Readings menu) puts two stretches of time side by side, so you can see whether things are changing. Under "What to compare", choose the last 7, 14 or 30 days with the same number of days before, or My own dates, which uses the From and To boxes for the newer stretch and the Earlier from and Earlier to boxes for the one to compare it with. Press Show. Results give each fact for both, such as "Average: 131, down from 142": how many days had readings, the average, time in your target range (and below and above it), lows, and the highest and lowest readings. If one stretch has far fewer days with readings, it says the comparison may not be fair.

Patterns by time of day
Patterns by time of day (in the Readings menu) shows how your sugar usually goes at different times of day, over the last 7, 14 or 30 days (it starts on 14). It first says which part of the day was highest and lowest on average, and when most lows were. Then it gives the day in four parts: overnight (12 AM to 6 AM), morning (6 AM to 12 PM), afternoon (12 PM to 6 PM) and evening (6 PM to 12 AM), each with its average, time in your target range, and number of lows.

Week highs and lows, and Find a reading
Week highs and lows (in the Readings menu, or Ctrl+W) opens a window with the 7 days ending today already shown: the highest and lowest, average, time in range, then day by day. Below it, Find a reading answers questions such as "When was my last reading of 300 or higher?" Choose Or higher or Or lower, type a number in the Number box (it starts at 300; choosing Or lower changes it to 70, unless you typed your own; in mmol/L these are 16.7 and 3.9), then press Find, or Enter in the Number box. Find results says when your last reading at or past that number was and how long ago, and how many separate times your readings were there in the last 30 days, with the longest. Readings in a row count as one time, so one high lasting an hour counts once, not as 12 readings; a break of more than 15 minutes between readings starts a new time. Finger sticks and scans count too.

Restore from a backup
Before the program changes your readings, food log or saved food lookups, it makes a backup in the Backups folder, inside the data folder, if backups are on in Settings. To put one back, press Restore from a backup (Alt+R) in Settings. The list shows your backups, newest first, such as "Food log, October 31st, 2026 at 2:15 PM". Choose one and press Restore; it asks first, with No as the button Enter presses. Before putting the backup back, the program backs up what is there now, so you can undo it by putting that one back. Enter on the list itself does nothing.

Estimated A1C
Estimated A1C (in the Readings menu) shows an estimate of your A1C, called GMI, for the last 14, 30 and 90 days, so you can see which way it is going. It is worked out from the average of your readings with a standard formula. Each time, a warning comes first, explaining that it is only an estimate and not a lab A1C test; press I understand and agree to see it, or Cancel to go back. Each estimate needs at least 14 days with sensor readings, and readings that go back that far; if not, the program says so instead of giving that number. It counts back from today, or from your newest reading if you haven't imported a newer file.

What is new
Updates
Press Check for updates in the Help menu to see whether a newer version is out. In Settings, "Updates when the program opens" chooses whether the program also checks each time it opens (Update automatically, Ask me first, or Don't check). "Which updates" (Alt+I) chooses which kind you are offered: "Stable releases only", which the program starts on, or "Stable releases and betas". Stable releases, such as 1.0 and 1.1, are tested and ready for everyday use. Betas, such as 1.1 beta 1, come out in between with newer features sooner, but they may have bugs; choose them if you would like to help test. An update never changes your readings, food log, settings or backups.

Problem log
If something goes wrong, the program can write what happened to a file called "problem log.txt" in the data folder, so it can be reported and fixed. In Settings, under Problem log (Alt+L), choose how much it writes: Off (nothing at all), Errors only (crashes and error messages; the program starts on this), Errors and information (also the program opening and closing, imports, updates, backups and settings saved), or Everything (also each button pressed and what each window said). Everything can include your readings and food log words, because it writes what the windows show, so only choose it when you are asked to, and switch back to Errors only afterwards. Your email address and USDA key are never written, whatever you choose. Only the last 7 days are kept. To send it, press View the problem log in Notepad (Alt+V), press Control+A to select it all and Control+C to copy it, then paste it into an email with Control+V.

"Change log.txt" in this folder lists what was changed, updated, or added in each version, newest first.

Reporting problems
Please email jamminjerry2011@gmail.com and say what happened, what you expected, and, if you use a screen reader, what it said.
